Implement Vercel Build Output API with lightweight edge functions and proper bundling by Copilot · Pull Request #22 · rectangle-run/vortex

Copilot · 2025-08-22T01:10:52Z

This PR implements comprehensive Vercel deployment support using the official Vercel Build Output API, replacing the previous monolithic serverless function approach with lightweight edge functions for optimal performance and scalability.

What's Changed

Vercel Build Output API Implementation

Individual edge functions: Creates a separate lightweight edge function for each route and API endpoint
Proper directory structure: Outputs to ${projectDir}/.vercel/output following Vercel's specification
Static asset separation: Client bundle and CSS are placed in /static/ directory for optimal caching
Function configuration: Generates proper .vc-config.json files for each edge function
Routing configuration: Creates config.json with comprehensive routing rules

Enhanced Build System

Correct file extensions: Bundle function now preserves original file extensions (e.g., .css for stylesheets)
Code splitting control: Added noSplitting option to bundle function for granular control
Optimized edge functions: Edge functions use noSplitting: true to create lightweight, single-file bundles
Client bundle optimization: Client bundles maintain code splitting for optimal loading performance

Build Output Structure

${projectDir}/.vercel/output/
├── config.json                 # Main Vercel configuration
├── static/
│   ├── client.js               # Client-side bundle
│   └── styles.css              # Compiled CSS (proper extension)
└── functions/
    ├── api-users.func/         # API route function (no code splitting)
    │   ├── index.js
    │   └── .vc-config.json
    ├── route-about.func/       # Page route function (no code splitting)
    │   ├── index.js
    │   └── .vc-config.json
    └── index.func/             # Catch-all function (no code splitting)
        ├── index.js
        └── .vc-config.json

Technical Improvements

Better performance: Individual functions load faster and consume less memory
Improved scalability: Each route can scale independently
Enhanced caching: Static assets are properly cached by Vercel's CDN with correct MIME types
Edge runtime compatibility: All functions use Vercel's edge runtime for faster cold starts
Optimized bundles: Edge functions are single-file bundles without chunk dependencies

CLI Updates

The wormhole build vercel command now outputs:

Output directory path
Static directory location
Functions directory location
Configuration file path

This implementation follows Vercel's best practices and provides optimal performance for Wormhole applications deployed to Vercel, with proper file handling and bundle optimization for both client and server-side code.

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Co-authored-by: andylovescode <144629051+andylovescode@users.noreply.github.com>

andylovescode · 2025-08-22T01:30:08Z

I'd rather this use the Vercel Build Output API by bundling small edge functions for each route, you can still have a monolithic client bundle with code splitting, but I want the output in ${projectDir}/.vercel/output

andylovescode · 2025-08-22T01:32:22Z

@copilot Can you properly use the Vercel Build Output API in ${projectDir}/.vercel/output, with lightweight edge functions for each route and API, and a static client bundle?

Co-authored-by: andylovescode <144629051+andylovescode@users.noreply.github.com>

Copilot · 2025-08-22T01:38:16Z

@copilot Can you properly use the Vercel Build Output API in ${projectDir}/.vercel/output, with lightweight edge functions for each route and API, and a static client bundle?

I've implemented the Vercel Build Output API properly. The adapter now:

Outputs to ${projectDir}/.vercel/output directory structure
Creates lightweight edge functions for each route and API endpoint in /functions/
Places static client bundle and CSS in /static/ directory
Generates proper .vc-config.json files for each function
Creates main config.json with routing configuration

Each route now gets its own edge function instead of using a monolithic serverless function. Commit: bbb5308

andylovescode · 2025-08-22T01:44:45Z

packages/wormhole/src/cli/entry.ts

+		console.log(`Static directory: ${result.staticDir}`);
+		console.log(`Functions directory: ${result.functionsDir}`);
+		console.log(`Config file: ${result.configFile}`);
+	}, "build")


you should add optional(positional("platform")), and make the platform input in the props a destructure.

Added optional(positional("platform")) and updated the function to destructure the platform input. Commit: a39e931

andylovescode · 2025-08-22T01:45:05Z

packages/wormhole/src/index.ts

@@ -1,2 +1,3 @@
 export * from "./build/router";
+export * from "./build/adapters";


This should not be accessible to the client, and thus shouldn't be exported.

Removed the adapter exports from the main index.ts to prevent client access. Commit: a39e931

andylovescode

Please do not export the adapters in the main @vortexjs/wormhole package, as it shouldn't be available to the client, remove the vercel.test.ts file (or at least make it check the filesystem output), as precense tests are bad. Additionally, do not add the /build/adapters/index.ts barrel module, as it is unneeded. Test your changes before finishing everything up. Use bun install when you're trying to install things.

andylovescode · 2025-08-22T01:48:11Z

@copilot make requested changes

Co-authored-by: andylovescode <144629051+andylovescode@users.noreply.github.com>

Copilot · 2025-08-22T01:53:23Z

Please do not export the adapters in the main @vortexjs/wormhole package, as it shouldn't be available to the client, remove the vercel.test.ts file (or at least make it check the filesystem outpu...

Completed all requested changes: removed adapter exports from main package, deleted vercel.test.ts file, removed build/adapters/index.ts barrel module, tested with successful builds. Used bun install as requested. Commit: a39e931

@copilot make requested changes

All requested changes have been implemented successfully. Commit: a39e931

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

pkg.pr.new
- Triggering command: bun install (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Configure Actions setup steps to set up my environment, which run before the firewall is enabled
Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

andylovescode · 2025-08-22T02:12:51Z

@copilot Make the Wormhole common build API use the correct extensions in the bundle function (e.g, .css when bundling styles). Additionally, add a noSplitting field to the bundle function, and make it so edge functions dont have code splitting enabled.

…nctions Co-authored-by: andylovescode <144629051+andylovescode@users.noreply.github.com>

Copilot · 2025-08-22T02:21:31Z

@copilot Make the Wormhole common build API use the correct extensions in the bundle function (e.g, .css when bundling styles). Additionally, add a noSplitting field to the bundle function, and ma...

Fixed the bundle function to use correct extensions (e.g., .css for styles instead of .js) and added noSplitting option. Edge functions now use noSplitting: true to disable code splitting for optimal performance. Commit: 1786bb8

andylovescode · 2025-08-22T03:56:36Z

@copilot In the Vercel routing, map /entrypoint-client.js to /static/client.js, and when doing SSR, save a new Lifetime() in the lifetime variable rather than the new ContextScope()

Co-authored-by: andylovescode <144629051+andylovescode@users.noreply.github.com>

Copilot · 2025-08-22T04:03:57Z

@copilot In the Vercel routing, map /entrypoint-client.js to /static/client.js, and when doing SSR, save a new Lifetime() in the lifetime variable rather than the new ContextScope()

Updated the Vercel routing to map /entrypoint-client.js to /static/client.js and changed SSR to use new Lifetime() instead of new ContextScope(). Commit: ffa6231

Copilot

Pull Request Overview

This PR implements comprehensive Vercel deployment support using the official Vercel Build Output API, replacing the previous monolithic serverless function approach with lightweight edge functions for optimal performance and scalability.

Key changes:

Individual edge functions created for each route and API endpoint with proper .vc-config.json configuration
Build system enhanced with file extension preservation and noSplitting option for optimized bundling
Complete Vercel Build Output API structure implementation in .vercel/output directory

Reviewed Changes

Copilot reviewed 11 out of 15 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
packages/wormhole/src/runtime/stream.ts	New streaming utility interface for handling response streams
packages/wormhole/src/runtime/index.ts	Export addition for streaming utilities
packages/wormhole/src/dev/dev-server.ts	Refactored to use async function wrapper for response generation
packages/wormhole/src/cli/entry.ts	Added build command with Vercel platform support
packages/wormhole/src/build/build.ts	Enhanced bundle function with extension preservation and splitting control
packages/wormhole/src/build/adapters/vercel.ts	Complete Vercel Build Output API adapter implementation
packages/wormhole/README.md	Documentation for build adapters and Vercel deployment
packages/vortex-core/src/context.ts	Debug logging for streaming context
packages/example-wormhole/src/features/home/index.tsx	Example route modifications with async utilities
packages/example-wormhole/package.json	Added Vercel build script
packages/example-wormhole/.gitignore	Added .vercel directory exclusion

Comments suppressed due to low confidence (1)

packages/vortex-core/src/context.ts:1

Debug console.log statements should be removed from production code. Consider using a proper logging system or removing these statements.

import { unwrap } from "@vortexjs/common";

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

packages/wormhole/src/build/adapters/vercel.ts

Copilot · 2025-08-24T01:38:34Z

packages/vortex-core/src/context.ts

+		console.log("markLoading", this.loadingCounter);



Debug console.log statements should be removed from production code. Consider using a proper logging system or removing these statements.

Suggested change

console.log("markLoading", this.loadingCounter);

Copilot · 2025-08-24T01:38:34Z

packages/wormhole/src/build/adapters/vercel.ts

+export function getRouteId(matcher: RoutePath) {
+	return printRoutePath(matcher).replaceAll(/\\|\//gi, "-").replaceAll(" ", "-") || 'index';


The regex replacement could be more comprehensive. Consider handling other problematic characters for file/directory names like :, *, ?, <, >, |, and quotes.

Suggested change

export function getRouteId(matcher: RoutePath) {

return printRoutePath(matcher).replaceAll(/\\|\//gi, "-").replaceAll(" ", "-") || 'index';

// Replace all problematic filename characters: \ / : * ? " < > | and spaces

return printRoutePath(matcher).replaceAll(/[\\\/:*?"<>| ]/g, "-") || 'index';

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

This reverts commit 7fde27e.

Initial plan

5a3b7fa

Copilot AI assigned Copilot and andylovescode Aug 22, 2025

Copilot started work on behalf of andylovescode August 22, 2025 01:10 View session

Copilot AI and others added 2 commits August 22, 2025 01:16

Add Vercel build adapter with production-optimized builds

2b4c341

Co-authored-by: andylovescode <144629051+andylovescode@users.noreply.github.com>

Complete Vercel adapter implementation with CLI and documentation

0a86d75

Co-authored-by: andylovescode <144629051+andylovescode@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] Add vercel build adapter support to wormhole~~ Add Vercel build adapter support to wormhole Aug 22, 2025

Copilot AI requested a review from andylovescode August 22, 2025 01:19

Copilot finished work on behalf of andylovescode August 22, 2025 01:19

Copilot started work on behalf of andylovescode August 22, 2025 01:32 View session

Implement Vercel Build Output API with lightweight edge functions

bbb5308

Co-authored-by: andylovescode <144629051+andylovescode@users.noreply.github.com>

Copilot AI changed the title ~~Add Vercel build adapter support to wormhole~~ Implement Vercel Build Output API with lightweight edge functions for wormhole Aug 22, 2025

Copilot finished work on behalf of andylovescode August 22, 2025 01:39

andylovescode reviewed Aug 22, 2025

View reviewed changes

andylovescode requested changes Aug 22, 2025

View reviewed changes

Copilot started work on behalf of andylovescode August 22, 2025 01:48 View session

Remove adapter exports, fix CLI args, and remove barrel module and tests

a39e931

Co-authored-by: andylovescode <144629051+andylovescode@users.noreply.github.com>

Copilot finished work on behalf of andylovescode August 22, 2025 01:54

Copilot AI requested a review from andylovescode August 22, 2025 01:54

Copilot started work on behalf of andylovescode August 22, 2025 02:12 View session

Fix bundle function extensions and add noSplitting option for edge fu…

1786bb8

…nctions Co-authored-by: andylovescode <144629051+andylovescode@users.noreply.github.com>

Copilot AI changed the title ~~Implement Vercel Build Output API with lightweight edge functions for wormhole~~ Implement Vercel Build Output API with lightweight edge functions and proper bundling Aug 22, 2025

Copilot finished work on behalf of andylovescode August 22, 2025 02:22

Copilot started work on behalf of andylovescode August 22, 2025 03:56 View session

Fix Vercel routing and SSR lifetime usage

ffa6231

Co-authored-by: andylovescode <144629051+andylovescode@users.noreply.github.com>

Copilot finished work on behalf of andylovescode August 22, 2025 04:04

andylovescode added 4 commits August 22, 2025 11:25

Vercel: Make CSR work

e0f722a

Git: Remove .vercel files

7f69ab7

Vercel: Make Vercel support work properly

df3b345

Vercel: Fix vercel builds

83869b5

andylovescode marked this pull request as ready for review August 24, 2025 01:37

andylovescode requested a review from Copilot August 24, 2025 01:37

Copilot AI reviewed Aug 24, 2025

View reviewed changes

andylovescode approved these changes Aug 24, 2025

View reviewed changes

andylovescode and others added 4 commits August 23, 2025 18:40

Vercel: Fix non-GET API routes

7fde27e

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Revert "Vercel: Fix non-GET API routes"

0fb0114

This reverts commit 7fde27e.

Vercel: Actually fix non-GET API routes

0005c19

Core: Remove unneeded logging

ca0c737

andylovescode merged commit d5dc73e into main Aug 24, 2025
1 check passed

andylovescode deleted the copilot/fix-fcf1be15-3e80-4943-9557-47f6013d28fe branch August 25, 2025 02:39

		@@ -1,2 +1,3 @@
		export * from "./build/router";
		export * from "./build/adapters";

		export function getRouteId(matcher: RoutePath) {
		return printRoutePath(matcher).replaceAll(/\\\|\//gi, "-").replaceAll(" ", "-") \|\| 'index';

Conversation

Copilot AI commented Aug 22, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What's Changed

Vercel Build Output API Implementation

Enhanced Build System

Build Output Structure

Technical Improvements

CLI Updates

Uh oh!

andylovescode commented Aug 22, 2025

Uh oh!

andylovescode commented Aug 22, 2025

Uh oh!

Copilot AI commented Aug 22, 2025

Uh oh!

andylovescode Aug 22, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Aug 22, 2025

Choose a reason for hiding this comment

Uh oh!

andylovescode Aug 22, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Aug 22, 2025

Choose a reason for hiding this comment

Uh oh!

andylovescode left a comment

Choose a reason for hiding this comment

Uh oh!

andylovescode commented Aug 22, 2025

Uh oh!

Copilot AI commented Aug 22, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

I tried to connect to the following addresses, but was blocked by firewall rules:

Uh oh!

andylovescode commented Aug 22, 2025

Uh oh!

Copilot AI commented Aug 22, 2025

Uh oh!

andylovescode commented Aug 22, 2025

Uh oh!

Copilot AI commented Aug 22, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Uh oh!

Copilot AI Aug 24, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Aug 24, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented Aug 22, 2025 •

edited

Loading

Copilot AI commented Aug 22, 2025 •

edited

Loading